home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
macorg32.zip
/
HCOMP40.ZIP
/
HOTCOMP.DOC
next >
Wrap
Text File
|
1993-01-20
|
7KB
|
174 lines
╔═════════════════════════════╗
║ A MÄC's Place BBS Release ║
╚═════════════════════════════╝
The HotStuff Companion
~~~ ~~~~~~~~ ~~~~~~~~~
Copyright (C)1989,1990
Version 4.0
Written By: John W. McNamara
MÄC's Place BBS
Dunn, North Carolina
919-891-1111
USR HST Dual Standard V.32 V.42
HOTCOMP - Version 4.0 Page - 1
╔══════════════╗
║ Introduction ║
╚══════════════╝
As with all of MÄC's Place BBS software if you forget the
arguments to add after the program name. Just type HOTCOMP
by itself and the instructions come up.
Welcome to the HotStuff Companion !! The program was written
because of the need to strip the DOWNLOAD.TXT and CALLER files
created by PCBoard (tm) of old, outdated, or unwanted files.
When HotStuff runs, it may reflect reflect files that are no
longer on your Bulletin Board System. There may be other uses
for the HotStuff Companion program as well such as producing
special files that other programs can read such as ProWho.
The program uses a routine similar to the UNIX Grep command
(although HOTCOMP's routine is unique !!). It will search a
file line by line for a string identified on the command line.
If the string is NOT contained in the line that it is searching,
that line is printed to a file. The original file is not changed.
╔═════════════════════════════╗
║ Files included in this ZIP: ║
╚═════════════════════════════╝
HOTCOMP.EXE - Main HotStuff Companion Executable File.
HOTCOMP.DOC - Information on HotStuff Companion Utility
HOTCOMP.HIS - Programme Release History in reverse order
HOTCOMP - Version 4.0 Page - 2
╔═══════════════════════════════╗
║ HotStuff Companion Operation: ║
╚═══════════════════════════════╝
The operation of the HotStuff Companion program is straight
forward. The program is invoked from the command line:
CORRECT USAGE:
HOTCOMP [inputfile] [outputfile] [filename1] [filename2] [filename3]
InputFile: File Containing Unwanted String. (DOWNLOAD.TXT or CALLERS)
OutputFile: Temporary File for Output (Will be a Backup of Original)
FileName1: Pattern to Strip from InputFile
FileName2: Pattern to Strip from InputFile (Optional)
FileName3: Pattern to Strip from InputFile (Optional)
HOTCOMP is NOT case sensitive, it will parse ONLY upper
case for the text string [filename] variable. However you can
enter it in lower case as the program will change it if it needs
too.
HOTCOMP reads from the [InputFile] and outputs only the lines that
Do NOT contain the search strings [filename] and writes them to the
[OutputFile]. HOTCOMP detects the difference between DOWNLOAD.TXT
files and the CALLER log. HOTCOMP keeps the CALLERS log intact
including the 63 column format. The [InputFile] and [OutputFile]
are swapped at the completion of the program so that you do not
have to rename the [OutputFile]. The HOTSTUFF program is now
ready to run on the filename you had for the [InputFile].
The program has other uses as well. For instance, if you need to
strip the DOWNLOAD.TXT file of all upload entries then you use the
command:
HOTCOMP Download.Txt TempFile scanv dsz shez
This will delete all references to the SCANV or DSZ or SHEZ
programs. This is helpful in maintaining the record integrity.
After getting a newer version of a program there is NO need to
have the download file contain all the old versions of it.
HOTCOMP Download.Txt TempFile (U)
HOTCOMP scans for the string '(U)' and parse out all these lines.
When the program finishes, the file: Download.Txt will contain
only download files [thus, it is stripped of all uploads] and the
file "TempFile" will contain all the original information.
The program has other uses as well. For instance, if you need to
strip the CALLERs log file of Qwik Mail entries then you use the
command:
HOTCOMP CALLER TempFile .qwk
HOTCOMP scans for the string '.qwk' and parse out all these lines.
When the program finishes, the file: CALLER will contain
no lines containing any Qwik Mail Items. The file TempFile will
contain all the original information.
HOTCOMP - Version 4.0 Page - 3
You can also eliminate a specific string [filename] from the
[InputFile]. For example, to parse any reference to the DSZ
program, you could use the command:
HOTCOMP Download.Txt TempFile DSZ
HOTCOMP would scan for the string 'DSZ' and parse out
these lines. When the program completed, the file Download.Txt
would be cleaned of any reference to DSZ
╔══════════════════╗
║ Acknowledgements ║
╚══════════════════╝
This program was conceived and created by John McNamara - the
SysOp of MÄC's Place [919-891-1111] HST
The HOTStuff Companion program is written in C and compiled with
Microsoft C 6.0. The C language was choosen for writing all of
the MÄC's Place BBS PCBoard utilities such as HOTCOMP because
of its speed and flexibility. The MSC source is NOT available.
If you have any comments, suggestions or improvements for the
HotStuff Companion program, please contact MÄC's Place BBS
919-891-1111 and leaving a comment to the SysOp. The author,
John McNamara can be contacted there or through the SHAREWARE
conference which is one of the national PCRelay International
network conferences.
Thanks !!